Management API

Base Resource URL:

     https://sandbox-portal.tidypay.com/api/v01/users/[user-name]/merchants

Description:

Represents Merchants, associated with the given user.

Supported Actions:

add  
Method:  POST       Implicit:  No       Returns:  ServiceResponse      
Consumes:  xurl  Produces:  json, xml 
 
Provides a user with access to a merchant. Multiple merchants can be added to a user.

Parameters:
# Name Type Required Default Description
01 code Integer Yes Identifier of a merchant or account that is going to be added to the specified user.


find  
Method:  GET       Implicit:  No       Returns:  Merchant[] *      
Consumes:  xurl  Produces:  json, xml 
 
Lists all Merchants currently configured for this user.

Parameters:
# Name Type Required Default Description
01 offset Integer No 0 Index of the first record returned to the customer from the search result of a web search.
02 limit Integer No 100 Maximum number of records to load per single search web call made by the customer.
03 id Integer No Query parameter to search merchants by merchant ID.
04 code Integer No Query parameter to search merchants by merchant code.
05 name Integer No Query parameter to search merchants by merchant name.


load  
Method:  GET       Implicit:  Yes       Returns:  Merchant *      
Consumes:  xurl  Produces:  json, xml 
 
Loads list of merchants that this user has access to.


remove  
Method:  POST       Implicit:  No       Returns:  ServiceResponse      
Consumes:  json, xml  Produces:  json, xml 
 
Removes user's access to a merchant.

Parameters:
# Name Type Required Default Description
01 code Integer Yes Identifier of a merchant or account that is going to be removed from the specified user.